home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 26 / AMIGAplus Sonderheft 26 (2000)(Falke)(DE)(Track 1 of 2)[!].iso / Tools / SFX-Player / Midi / Midi_Companion / Midi_Companion_V30.doc < prev    next >
Text File  |  1999-03-29  |  15KB  |  373 lines
  1. Midi Companion V3.0
  2.  
  3. (c) 1998 The Software Factory
  4.  
  5. Overview
  6. --------
  7.  
  8. Midi Companion is the first OctaMED plugin designed mainly for use 
  9. with the Roland MC-303 but a lot of it's features can be used on 
  10. other MIDI equipment.  Due to OctaMEDs current lack of multitasking 
  11. support, Midi Companion at this stage is an instrument setup utility. 
  12.  This means that you can initially setup all midi instrument 
  13. settings, ie. Bank Select, Preset, Pan, Volume, Portamento, Reverb 
  14. Type & Level, Chorus Type & Level, Cutoff, Resonance and much more.   
  15.                  
  16.  
  17. Some features of Midi Companion are specific to the Roland MC-303 and
  18.  they are as follows......
  19.  
  20. > Filter Cutoff
  21. > Filter Resonance
  22. > Reverb Type
  23. > Chorus Type
  24. > RX Nozte
  25. > Effect Parameters - Not available in this version.
  26.                                        
  27. Besides the specifics, all other functions are using standard midi
  28.  controllers and therefore can be used with any midi device.                                 
  29.  
  30. Requirements
  31. -------------------    
  32.  
  33. Midi Companion should run on any Amiga running OS2.04 or greater.
  34. At least 2Mb of memory is reccomended.
  35. OctaMED Sound Studio.                                        
  36. Midi Interface.
  37. Midi Instrument(s).   
  38.  
  39. Reccomended
  40. -------------------
  41.  
  42. A hard drive.
  43. Arexx installed and running on your system.
  44. A fast amiga. (The faster the better)    
  45.                        
  46. Executing Midi Conmpanion
  47. -------------------------
  48.  
  49. 1) You must have OctaMED Sound Studio running in order to use Midi
  50.    Companion.
  51.  
  52. 2) Before executing the Midi Companion program you MUST ensure Midi is
  53.    inactive within the OSS Midi menu.  Again, this is due to the lack
  54.    of multi tasking support within OSS.
  55.  
  56. 3) Return to workbench and execute the file Midi_Companion_V3.0 using
  57.    the CLI.
  58.                                                                            
  59. 4) Midi Companion will now open the Instrument Properties window
  60.    within the OSS screen.   
  61.  
  62. How to use Midi Companion
  63. -------------------------
  64.  
  65. To use any feature within Midi Companion you MUST ensure Midi is
  66.  inactive within the OSS Midi menu and Midi is selected within Midi 
  67. Companions instrument properties window.  This has to be reversed 
  68. when returning to OSS.  Midi Companions midi status is displayed in 
  69. the title bar of the instrument properties window.  
  70.  
  71. This process is automatic if Midi Companion is Arexx enabled.
  72.  
  73. Screen Layout and Instructions
  74. ------------------------------
  75.                       
  76. Instrument Properties
  77. ---------------------
  78.  
  79. Midi Companions midi status is displayed in the title bar or the
  80.  window.
  81.  
  82. If midi is switched on, Midi On, will be displayed.
  83.  
  84. If Arexx is active, the OSS Arexx command op_set midiactive off will
  85. be sent to OSS in order to ensure OSS Midi Active is off and midi 
  86. control returns to Midi Companion.
  87.        
  88. If midi is switched off, Midi Off, will be displayed.     
  89.  
  90. If Arexx is active, the OSS Arexx command op_set midiactive on will
  91. be sent to OSS in order to ensure OSS Midi Active is on and midi 
  92. control returns to OSS.     
  93.   
  94. Name : Relative to the currently selected Bank & Preset, the
  95.        appropiate tone name will be displayed. You can also 
  96.        enter or load your own tone names.                                     
  97.  
  98. Instr : This displays the currently selected instrument and also 
  99.         allows you to change between the 16 different instruments 
  100.         available.
  101.         
  102.         If Arexx is active, the OSS Arexx command in_select, will be
  103.          transmitted to OSS to reflect the change in Instrument.   
  104.  
  105. Midi Ch : This displays the currently selected midi channel and also
  106.           allows you to change between the 16 different midi chanels 
  107.           available.
  108.           
  109.           If Arexx is active, the OSS Arexx command in_setmidichannel,
  110.           will be transmitted to OSS to reflect the change in Midi
  111.            Channel.   
  112.           
  113. >>Note<<
  114.  
  115. As a default Midi Companion matches instrument 1 to midi channel 1, up
  116.  to instrument 16 matching midi channel 16.  
  117.                     
  118. Bank : This displays the currently selected bank and also allows you
  119.        to change between the 128 different banks available.
  120.           
  121. Preset : This displays the currently selected preset and also allows
  122.          you to change between the 128 different presets available. 
  123.            
  124.          If Arexx is active, the OSS Arexx command 
  125.          in_setmidipreset, will be transmitted to OSS to reflect the change
  126.          in Preset. 
  127.                                  
  128. Volume : This displays the volume level of the currently selected
  129.          instrument and also allows you to select a desired level.
  130.          
  131.          If Arexx is active, the OSS Arexx command 
  132.          in_setvolume, will be transmitted to OSS to reflect the change
  133.          in Volume. 
  134.                               
  135. Pan : This displays the current pan position of the currently selected
  136.       instrument and also allows you to select a desired position.
  137.       >>See Settings.doc for more info<<  
  138.                                                        
  139. P Time : This displays the current Portamento time of the currently 
  140.          selected instrument and also allows you to select a desired 
  141.          level.  This is not relevant if Portamento is switched off.
  142.          
  143. Reverb : This displays the current Reverb type and allows you to
  144.          select 1 of the 8 available.
  145.          >>This feature is MC-303 specific<<
  146.          
  147. Level : This displays the current reverb level and allows you to
  148.         select a desired level.
  149.        
  150. Chorus : This displays the current Chorus type and allows you to
  151.          select 1 of the 8 available.
  152.          >>This feature is MC-303 specific<<
  153.  
  154. Level : This displays the current reverb level and allows you to
  155.         select a desired level.
  156.  
  157. Cutoff : This displays the current filter cutoff level and allows you
  158.          to select a desired level.
  159.          >>This feature is MC-303 specific<< 
  160.        
  161. Reso : This displays the current filter resonance level and allows you
  162.        to select a desired level.
  163.        >>This feature is MC-303 specific<<    
  164.        
  165. Test : This button is used to test your current instrument settings.  
  166.        By pressing the keys listed in the file Test_Key.doc you can 
  167.        play scales on your amiga keyboard. 
  168.  
  169. Key : This number is relevant to the key you wish to test.  The
  170.       default is 60, which represents middle C.  Please refer to the 
  171.       Test_Key.doc file for the other key numbers.  As with OSS you can
  172.       press any of the keys on the lower part of the Amiga keyboard which
  173.       act like a musial keyboard spanning one octave, from Z to M.
  174.       To change the octave you can press the following function keys.
  175.       
  176.       F1 - Octave 0
  177.       F2 - Octave 1        
  178.       F3 - Octave 2        
  179.       F4 - Octave 3        
  180.       F5 - Octave 4        
  181.       F6 - Octave 5        
  182.       F7 - Octave 6        
  183.       F8 - Octave 7
  184.       F9 - Octave 8                              
  185.  
  186. Midi : This is used to switch midi on/off.
  187.  
  188. RX Note : This is used to turn on/off an MC-303 midi channel.  The
  189.           Roland MC-303, by default, responds to all channels so if 
  190.           you are using an MC-303 with other midi gear you would use 
  191.           this to turn off the midi channel not being used by the 
  192.           MC-303.  For compatibility, if you do not have a Roland MC-303
  193.           you should turn RX Note off for all your midi channels.    
  194.           >>This feature is MC-303 specific<<
  195.           
  196. Portamento : This is used to turn on/off Portamento.  Use the P Time 
  197.              slider to set the desired portamento time.
  198.                                                                    
  199. Menu Items
  200. ----------
  201.  
  202. >Project
  203. -------
  204.  
  205. Load Song Data :   
  206.  
  207.        This is used to load your instrument settings file from disk.
  208.        If Arexx is active, all relative settings will be transmitted
  209.        to OSS via Arexx.  
  210.  
  211. Load Tone Banks :
  212.  
  213.        Thisis used to load your tone bank names.                                                                                                                   
  214.               
  215. Save : This is used to save your instrument settings file to disk.
  216.        The files have been given a file extension of .mc3
  217.                                                                                    
  218. About : This open a small window which displays the version of Midi
  219.         Companion being used, it's shareware status and the authors 
  220.         name. 
  221.         
  222. Quit : Use this to quit Midi Companin.                                      
  223.        
  224. >Window
  225. ------
  226.  
  227. Effect Parameters : This allows you to make detailed settings to the
  228.                     system effects.  Please refer to the Roland 
  229.                     MC-303 owners manual for a more detailed 
  230.                     explanation.  
  231.                     
  232.                     >>This is MC-303 specific<<               
  233.                     
  234.                     To iconify this window simply click the right mouse
  235.                     button and to un-iconify simply click on the close
  236.                     gadget. 
  237.                     
  238. NRPN Setup : This very useful window allows you to define your own set
  239.              of NRPN sliders.                                     
  240.               
  241.              The name field is for the user to enter a name relevant
  242.              to the NRPN being setup.  
  243.              
  244.              MSB is for setting the MSB of the NRPN being setup.
  245.                                              
  246.              LSB is for setting the LSB of the NRPN being setup.
  247.              
  248.              Data Entry is for setting the value relevant to the NRPN
  249.              being setup.
  250.              
  251.              Both MSN & LSB values should be documented in your
  252.              specific  midi instruments owners manual.   
  253.              
  254.              To iconify this window simply click the right mouse
  255.              button and to un-iconify simply click on the close
  256.              gadget. 
  257.              
  258. >>Iconify<<
  259. -----------
  260.  
  261. To iconify the instrument properties window, simply click on the close
  262. gadget and choose Iconify from the requester.
  263.  
  264. To un-iconify the instrument properties window, simply click on the
  265.  close gadget again.                        
  266.  
  267. Arexx
  268. -----
  269.  
  270. Midi Companion has a little Arexx support at the moment and this will
  271. improve within as time goes by.
  272.  
  273. When Arexx is active within Midi Companion, certain sliders when moved,
  274. will also change values with OctaMED itself.
  275.  
  276. The OctaMED parameters affected are Instrument Number, Midi Channel,
  277. Preset, Volume and the Midi Active switch.
  278.                                       
  279. To turn Arexx on within Midi Companion you need to send the command
  280. AREXX_ON to the MIDI_COMPANION Arexx port.  To do this, simply type
  281. RX "address MIDI_COMPANION AREXX_ON" into the shell. 
  282.  
  283. To turn Arexx off within Midi Companion you need to send the command
  284. AREXX_ON to the MIDI_COMPANION Arexx port.  To do this, simply type
  285. RX "address MIDI_COMPANION AREXX_OFF" into the shell.  This is the
  286. default at startup.               
  287.  
  288. Obviously, the speed of this feature will go un-noticed with a fast
  289. Amiga, as on my 030 30MHz A1200.
  290.              
  291. Disclaimer
  292. ----------
  293. The author, Declan Gorman, bears no responsibility for loss of data or
  294.  damage to hardware while using Midi Companion.  (Although this is
  295.   highly unlikely.)
  296.                                                                      
  297. Background
  298. ----------
  299. Having battled with the Roland MC-303 sound module mode for a while I
  300.  pondered if there was any utilities available that would make life 
  301. easier for me.  After much searching I could find absolutley 
  302. nothing and this prompted me to do some research into what exactly 
  303. would be involved in designing such a utility.  When my research was 
  304. complete I decided to take on the project myself as I have had some 
  305. programming experience.
  306.  
  307. I studied the Roland MC-303 manual until I got an understanding of all
  308. the Sysex messages that I needed to understand in order to make this 
  309. project succeed. I think you will agree when I say that it has 
  310. succeeded.
  311.  
  312. All coding on this project was done on an 10Mb Amiga 1200 030/30 using
  313. AMOS Professional V2, and a lot of help from an excellent extension
  314. called The GUI Extension.  My thanks go to everyone on the AMOS
  315.  mailing list who gave help and advice in the early days of this 
  316. project.
  317.  
  318. The Software Factory
  319. --------------------
  320.  
  321. TSF consists of just one person, me!.  My name is Declan Gorman and I
  322.  hail from Ireland.  I can be contacted by email or snail mail and 
  323. the addresses are as follows :
  324.  
  325. email : Declan_Gorman@modusmedia.com
  326.  
  327. snail mail :    Declan Gorman
  328.                 2555 Woodside Park
  329.                 Kildare Town
  330.                 Co. Kildare
  331.                 Eire.
  332.                 
  333. I can be contacted for any reason regaring Midi Companion as long as
  334.  you have read the documentation thoroughly.  Obviously queries made 
  335. via email will be answered faster so I would advise using this method 
  336. if at all possible.  All bug reports, requests for improvements, etc. 
  337. should also be directed to the above addresses.
  338.  
  339. Shareware
  340. ---------
  341.  
  342. I initially designed Midi Companion for myself alone but as I got more
  343. and more into the project, I saw it had a lot of potential and knew 
  344. that there were a lot of other OctaMED/Midi/MC-303 users out there 
  345. that could benefit and appreciate Midi Companion.
  346.  
  347. I hope you can appreciate that a lot of hard work has gone into this
  348.  project and the shareware option is a fair way for me and you, the 
  349. user, to go. 
  350.  
  351. Shareware involves you evaluating a partially crippled version of Midi
  352. Companion and deciding if you like it and want to avail of the
  353.  crippled features, free upgrades and free support.  Should you 
  354. decide that this software is what you want in order to get the best 
  355. out of OSS and your Midi Equipment/MC-303, a shareware fee of IR£5 
  356. or the equivalent in your own currency should be sent to me at the 
  357. above quoted address.  Or you can contact me about credit transfer 
  358. through your bank.  I have placed a link to a web page that will 
  359. provide a currency conversion from your currency to Irish Punts on the
  360. Midi Companion home page.  
  361. http://members.tripod.com/"Declan/midi_com.htm
  362.  
  363. In this release version, the crippled features are the Load, Save,
  364.  Effects Parameters and NRPN Setup.  They become available to you 
  365. when you register.  I also have plans to add LFO support but this has 
  366. proved trickier than the other features so it may be a while before I 
  367. can implement it.  This will be issued to all registered users free of 
  368. charge as part of the registration.
  369.  
  370. Enjoy Midi Companion and thank you for taking the time to evaluate it.
  371.  
  372. Declan.                                    
  373.